home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-12 / tarb16.zip / TARGET16.DOC < prev    next >
Text File  |  1992-10-01  |  31KB  |  993 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                     TARGET
  18.                The McAfee File Locator and Manipulator V1.6BETA
  19.                      Copyright 1992 by McAfee Associates.
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.        McAfee Associates               (408) 988-3832 office
  48.        3350 Scott Blvd, Bldg. 14       (408) 970-9727 fax
  49.            Santa Clara, CA  95054          (408) 988-4004 BBS (25 lines)
  50.        U.S.A.                          USR HST/v.32/v.42bis/MNP1-5
  51.                        CompuServe    GO MCAFEE
  52.                                            InterNet      support@mcafee.COM
  53.  
  54.  
  55.  
  56.                               TABLE OF CONTENTS
  57.  
  58.  
  59. INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . 2
  60.  - What is TARGET?
  61.  - System requirements
  62.  
  63. AUTHENTICITY . . . . . . . . . . . . . . . . . . . . . . 4
  64.  - Verifying the integrity of TARGET
  65.  
  66. WHAT'S NEW . . . . . . . . . . . . . . . . . . . . . . . 5
  67.  - New features added in this release
  68.  
  69. Using TARGET . . . . . . . . . . . . . . . . . . . . . . 6
  70.  
  71. File Search Facilities . . . . . . . . . . . . . . . . . 13
  72.  
  73. File Manipulation Facilities . . . . . . . . . . . . . . 16
  74.  
  75. The TARGET and Target_DRIVES Environment Variables . . . 17
  76.  
  77. Registration . . . . . . . . . . . . . . . . . . . . . . 17
  78.  
  79. Technical Support. . . . . . . . . . . . . . . . . . . . 17
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.                                    Page 1
  109.  
  110. TARGET Version 1.6BETA                                    Page 2
  111.  
  112.  
  113. INTRODUCTION
  114.  
  115.  
  116.      TARGET is a powerful, multi-purpose file location and
  117. manipulation utility.  It can find selected files on all drives
  118. (including network drives) and perform actions on them such as
  119. copying, renaming, re-grouping, deleting, archiving, scanning for
  120. viruses, and many other functions.  TARGET can search for files
  121. based on their date ranges, file sizes, archive condition, file
  122. type, duplicate files, and use a variety of search masks such as
  123. regular expressions.
  124.  
  125.      TARGET can perform a wide range of actions on found files,
  126. ranging from simple deletions and virus scans to complex
  127. re-structurings or re-orderings.  Here are some operations that
  128. can be performed with one simple TARGET command:
  129.  
  130.      - Locate all .DOC files in all the sub-directories of
  131.        local and network drives, incorporate them into one .ZIP
  132.        archive file, and then delete all of the unarchived
  133.        .DOC files.
  134.  
  135.      - Find all files on all drives modified in the past five days
  136.        and copy them to a floppy diskette for backup purposes.
  137.  
  138.      - Remove all files from your archives that are more than
  139.        five years old.
  140.  
  141.       - Move all files with a given extension on your network
  142.         into one sub-directory.
  143.  
  144.       - Create an archive of all files that are greater than 2Mb
  145.         long.
  146.  
  147.       - Search all drives for files with the numbers 1 through 5
  148.         as the last character of the filename and scan them for
  149.         viruses.
  150.  
  151.       - Determine wasted space occupied by backup files,
  152.         archives, old files, or any other file classifications.
  153.  
  154.  
  155. TARGET provides a number of search options, including:
  156.  
  157.       - The ability to search inside .ARC, .ZIP, .PKA, .PAK,
  158.         .ZOO, .ARJ, and .LZH archived files.
  159.  
  160.       - The ability to search for files compressed with PKWare's
  161.          PKLite program.
  162.  
  163.  
  164.  
  165. TARGET Version 1.6BETA                                    Page 3
  166.  
  167.  
  168.       - True regular expression searching on filenames.
  169.  
  170.       - The ability to display duplicate entries across all disk
  171.         drives, including duplicates that are in archive files.
  172.  
  173.       - Excluding files from a search based on a search mask.
  174.  
  175.       - The ability to do restrictive searches on such criteria
  176.         as file date ranges and file sizes, archive bit settings,
  177.         hidden file flags and other file characteristics.
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220. TARGET Version 1.6BETA                                    Page 4
  221.  
  222.  
  223. AUTHENTICITY
  224.  
  225.      TARGET is packaged with the VALIDATE program to ensure the
  226. integrity of the TARGET.EXE file.  The VALIDATE.DOC file tells
  227. howto use VALIDATE.  VALIDATE can be used to check subsequent
  228. versions of TARGET for tampering.
  229.  
  230.      The validation results for Version 1.6 Beta should be:
  231.  
  232.               FILE NAME: TARGET.EXE
  233.                    SIZE: 77,060
  234.                    DATE: 10-01-1992
  235.     FILE AUTHENTICATION
  236.          Check Method 1: B748
  237.          Check Method 2: 0E3B
  238.  
  239. If your copy of TARGET differs, it may have been damaged.
  240. Always obtain your copy of TARGET from a known source.  Valid
  241. copies can be obtained from McAfee Associates' bulletin board
  242. system at (408) 988-4004, the McAfee Virus Help on CompuServe
  243. (GO MCAFEE), or by anonymous ftp from the Internet mcafee.COM
  244. site.
  245.  
  246.      All of McAfee Associates programs are archived with
  247. PKWare's PKZIP Authentic File Verification.  If you do not see
  248. an "-AV" after every file is unzipped and receive the "Authentic
  249. Files Verified! # NWN405 Zip Source: McAFEE ASSOCIATES" message
  250. when you unzip the files then do not use them.  If your version
  251. of PKUNZIP does not have verification ability, then this message
  252. may not be displayed.
  253.  
  254.      Please contact us if you believe tampering has occurred to
  255. the .ZIP file.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275. TARGET Version 1.6BETA                                    Page 5
  276.  
  277.  
  278. WHAT'S NEW
  279.  
  280.      Version 1.6BETA of TARGET adds one new feature, the -UPDATE
  281. switch.  With this new switch, TARGET now can replace multiple
  282. copies of a file or list of files with an updated version.  This
  283. can be used to update several copies of a program found on multiple
  284. or networked drives.
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330. TARGET Version 1.6BETA                                    Page 6
  331.  
  332.  
  333. USING TARGET
  334.  
  335. FILE SEARCH FACILITIES
  336.  
  337.      Locating files with TARGET is simple and intuitive.  If you
  338. do not specify a path, then TARGET will search the entire
  339. default drive.  If you specify a starting path, then the search
  340. will occur from that path downward.
  341.  
  342.   Here are some basic command line examples:
  343.  
  344.   TARGET ab*.c                  search entire default drive for any filename
  345.                 matching "ab*.c".
  346.  
  347.   TARGET \turboc\ab*.c          search downward from the \turboc\ directory
  348.                 on the default drive looking for "ab*.c".
  349.  
  350.   TARGET d:*.dat -a             search entire drive d: and all archive files
  351.                 on drive d: looking for "*.dat".
  352.  
  353.   TARGET cd:*.dat -a            search entire drive c: and drive d: and all
  354.                 archive files looking for "*.dat".
  355.  
  356.   TARGET myprog                 search entire default drive looking for
  357.                                 "myprog.*" (TARGET will append a ".*" to
  358.                 a filename with no extension specified).
  359.  
  360.   TARGET myprog.                search entire default drive looking for
  361.                 "myprog".  If you specify a "." after a
  362.                                 filename, TARGET will not append an "*" to it.
  363.  
  364.  
  365. Command Line Switches
  366.  
  367.     Switch:  -A
  368.     Meaning:  search all archive files
  369. Description:  The '-a' switch tells TARGET to look in any archive file
  370.           encountered for a matching filename.  If a matching filename
  371.           is found, it will be displayed in parenthesis along with the
  372.           full name of the archive file it resides in.
  373.  
  374.  
  375.      Switch:  -AO
  376.     Meaning:  search -ONLY- archive files
  377. Description:  The '-ao' switch tells TARGET to ONLY look in any archive file
  378.           encountered for a matching filename.  If a matching filename
  379.           is found, it will be displayed in parenthesis along with the
  380.           full name of the archive file it resides in.
  381.  
  382.  
  383.  
  384.  
  385. TARGET Version 1.6BETA                                    Page 7
  386.  
  387.  
  388.      Switch:  -ARC -ARJ -PKA -LZH -ZIP -ZOO
  389.     Meaning:  search only the archive formats specified
  390. Description:  These switches tell TARGET to only look inside the specified
  391.           types of archive files for a matching filename.  For example,
  392.           if you are sure that the file named MYPROG.EXE is somewhere
  393.           on drive C: in a .ZIP file, then
  394.  
  395.                         TARGET c:myprog.exe -zip
  396.  
  397.           would find the file.  Specifying individual archive format
  398.               switches slightly speeds up TARGET, because the program doesn't
  399.           have to waste time searching for (and through) all six archive
  400.           formats.
  401.  
  402.  
  403.      Switch:  "regular expression"
  404.     Meaning:  do a grep-type search on the filename
  405. Description:  Any command line string enclosed within double quotes will be
  406.               considered a regular expression, and will cause TARGET to go
  407.           into its "grep mode".   A regular expression can be used with
  408.           or without a filename search mask.
  409.  
  410.               TARGET will also look inside of 4DOS description files for
  411.           the string specified.  If a match is found, the normal output
  412.           line will be displayed, along with the actual 4DOS description
  413.           line below the filename line.
  414.  
  415.           Special characters within the quoted string are as follows:
  416.  
  417.  
  418.               ^  -  start matching at the first character of
  419.                  the filename
  420.               ?  -  match any character in this position
  421.             [..] -  range check on character at this position
  422.  
  423.  
  424.           The easiest way to explain is with a few examples:
  425.  
  426.               TARGET *.bat
  427.  
  428.           the regular search; will display any .BAT file found.
  429.  
  430.  
  431.               TARGET *.bat "42"
  432.  
  433.           will display any .BAT file that contains the characters
  434.           "42" anywhere in the filename.
  435.  
  436.  
  437.               TARGET *.bat "^???42"
  438.  
  439.  
  440. TARGET Version 1.6BETA                                    Page 8
  441.  
  442.  
  443.                   will display any .BAT file that contains the characters
  444.           "42" in the fourth position of the filename.
  445.  
  446.  
  447.               TARGET "[0-9]"
  448.  
  449.           will display any file that contains a number anywhere in
  450.           the filename.
  451.  
  452.  
  453.               TARGET "[^0-9]"
  454.  
  455.           will display any file that DOES NOT contain a number
  456.           anywhere in the filename.
  457.  
  458.  
  459.               TARGET "^???a?[acew-z]"
  460.  
  461.           will display any file that contains an 'a' in the fourth
  462.           position of the filename and the letters 'a', 'c', 'e',
  463.           'w', 'x', 'y', or 'z' in the sixth position of the name.
  464.  
  465.  
  466.           These grep masks also work when looking inside of archive files.
  467.  
  468.  
  469.      Switch:  -D
  470.     Meaning:  search all available hard drives
  471. Description:  This switch tells TARGET to search every hard drive on your
  472.           system (including network drives), starting with C:.  In other
  473.           words, if you have drives C:, D:, E:, and F: then the following
  474.           two command lines would do the exact same thing:
  475.  
  476.                         TARGET cdef:myprog.exe
  477.             or
  478.                         TARGET myprog.exe -d
  479.  
  480.           Note that specifying the "-d" switch overrides any drive
  481.           letters that you specify on the command line.
  482.  
  483.  
  484.      Switch:  -DIR
  485.     Meaning:  include directory names in the search
  486. Description:  This switch tells TARGET to also include directory names in
  487.           the search.  This allows you to not only locate a lost file,
  488.           but lost directories, too.
  489.  
  490.  
  491.       Switch: -DUP
  492.      Meaning: Display only duplicate filenames on the drives searched
  493.  
  494.  
  495. TARGET Version 1.6BETA                                    Page 9
  496.  
  497.  
  498.  Description: If the -DUP switch is specified, only those files that have
  499.           duplicate entries will be displayed.  All other switches are
  500.           active during -DUPlicate processing.  For example, the
  501.           following command line:
  502.  
  503.                       TARGET *.bat -a -d -dup
  504.  
  505.               would cause TARGET to search all hard drives (-d) looking for
  506.               duplicate .BAT files.  TARGET would also look inside of all
  507.           found Archive files (-a).
  508.  
  509.       NOTE:  TARGET must keep filenames in memory when searching for
  510.          duplicate files.  If an extremely large disk is being searched
  511.          for duplicates, memory problems may occur.  If you  get the
  512.          message "Error: out of memory!" when trying to find duplicates
  513.          across all drives, then divide the search into overlapping
  514.          areas, or search by extension or other file characteristic
  515.          to limit the number of files reviewed in a given pass.
  516.          If you are looking for duplicates on a very large drive, then
  517.              TARGET will take some time.   Don't be alarmed if the program
  518.          seems to not be doing anything during its search.
  519.  
  520.  
  521.      Switch:  -E
  522.     Meaning:  use "*.*" for subdirectory searches
  523. Description:  By default, TARGET assumes that you don't have any directories
  524.           on your hard drive that have extensions in the filename.  So,
  525.               when TARGET is looking for new directories, it will search with
  526.           a filemask of "*.".   This significantly speeds up the hard drive
  527.           search.  If you do have directories that have extensions in their
  528.               names, you must specify the '-e' switch or TARGET -will not-
  529.           find files within that subdirectory.  The easiest thing to do is
  530.               to set your TARGET environment variable to default to this
  531.               option (see "The TARGET Environment Variable" below).
  532.  
  533.  
  534.      Switch:  -F
  535.     Meaning:  display filenames only
  536. Description:  This switch causes TARGET to display only the filename of
  537.           matching files that it finds.  No header or footer information
  538.           will be displayed.  This is most useful when you are
  539.               redirecting the output from TARGET to a file.
  540.  
  541.  
  542.      Switch:  -G or -GF
  543.     Meaning:  go to the drive and subdirectory of the found file
  544. Description:  If you specify the '-g' switch, TARGET will prompt you with
  545.  
  546.                 Goto this subdirectory? (Y/N/Q) _
  547.  
  548.           whenever it finds a matching file.  Press 'Y' to change to
  549.  
  550. TARGET Version 1.6BETA                                    Page 10
  551.  
  552.  
  553.           the drive and subdirectory displayed, or 'N' to continue
  554.               searching the drive.  You may also enter 'Q' to abort TARGET.
  555.               If you specify the '-gf' switch, TARGET will change to the
  556.           directory of the first found file without prompting you.
  557.  
  558.  
  559.      Switch:  -H or -HO
  560.     Meaning:  start searching in the current subdirectory
  561. Description:  The '-h' switch tells TARGET "start searching where I'm at
  562.           right now".   For example, if you are currently in the TURBOC
  563.           subdirectory, then the following two commands would do the
  564.           exact same thing:
  565.  
  566.                          TARGET \turboc\myprog.c
  567.              or
  568.                          TARGET myprog.c -h
  569.  
  570.               The '-ho' switch tells TARGET to both (a) start in the current
  571.           directory, and (b) to ONLY search the current directory.
  572.               With this switch, TARGET can be used as a directory program
  573.           with the ability to list archive files.   For example,
  574.           you could create the following batch file and call it
  575.           ARCDIR.BAT:
  576.  
  577.                 @echo off
  578.                             TARGET %1 -ho -a
  579.  
  580.           Now, when you give the command "ARCDIR", you will be shown
  581.           the directory listing, along with all files contained within
  582.           archive files in your current subdirectory.
  583.  
  584.  
  585.      Switch:  -I
  586.     Meaning:  ignore the environment variable TARGET
  587. Description:  The '-i' switch tells TARGET to ignore any default switches
  588.               that you have set with the TARGET environment variable.
  589.  
  590.  
  591.      Switch:  -M -R -PL
  592.     Meaning:  modify TARGET's default output display
  593. Description:  These switches allow you to modify the way that TARGET
  594.               displays its output.  By default, TARGET will place the
  595.           filename on the left of the screen (just like DIR does).
  596.           If you prefer, you can use '-M' to place the filename in the
  597.           middle of the screen, '-R' to place the filename on the
  598.           right of the screen, or '-PL' to put the pathname on the left
  599.           of the screen.  Usually set in the environment.
  600.  
  601.  
  602.  
  603.  
  604.  
  605. TARGET Version 1.6BETA                                    Page 11
  606.  
  607.  
  608.      Switch:  -K
  609.     Meaning:  search only the PATH directories
  610. Description:  This switch will cause TARGET to search only the directories
  611.           that are specified in your DOS PATH environment variable.
  612.  
  613.  
  614.      Switch:  -Y
  615.     Meaning:  display the output with European-style dates (DD-MM-YY)
  616.  
  617.  
  618.      Switch:  -W
  619.     Meaning:  show wasted space occupied by matching files
  620. Description:  This switch can come in handy if you are trying
  621.           to figure out how much disk space is being wasted
  622.           by a bunch of very small files (batch files are a prime
  623.               example).  TARGET will total and display to you the amount of
  624.           disk space that is being wasted due to cluster overhead.
  625.  
  626.  
  627.      Switch:  -U
  628.     Meaning:  display all output in upper case
  629. Description:  Some people still prefer to see directory-type listings in
  630.           ALL UPPER CASE; if you're one of these people, then just use
  631.               the '-U' switch.  It's best to set this in your TARGET
  632.           environment variable.
  633.  
  634.  
  635.      Switch:  -P
  636.     Meaning:  no pause or wait for a key when the screen fills up
  637. Description:  Will cause TARGET to not pause the screen when it
  638.           fills up.
  639.  
  640.  
  641.      Switch:  -PKLite
  642.     Meaning:  search for files compressed with PKLite
  643. Description:  This switch will cause TARGET to only look for .COM and
  644.           .EXE files that have been compressed with PKWare's PKLITE
  645.           program.  PKLite is a program that compresses executable
  646.           programs, and then un-compresses them at runtime.
  647.  
  648.  
  649.      Switch:  -Xfilemask
  650.     Meaning:  exclude this filespec from the search
  651. Description:  The '-X' switch allows you to exclude certain filenames from
  652.           the directory search.  You can specify up to 25 exclusion
  653.           masks.   For example, if you wanted to see all files on your
  654.           drive except for .OBJ and .PRG files, you could do:
  655.  
  656.                         TARGET *.* -x*.obj -x*.prg
  657.  
  658.  
  659.  
  660. TARGET Version 1.6BETA                                    Page 12
  661.  
  662.  
  663.      Switch:  -LT -EQ -GT
  664.     Meaning:  specify a file size range
  665. Description:  These switches allow you to search only for files within a
  666.           certain size range.  Some examples:
  667.  
  668.                          TARGET *.PAS -LT1024
  669.  
  670.           would display all .PAS files that have a size smaller than
  671.           1024 bytes.
  672.  
  673.                          TARGET *.* -EQ0
  674.  
  675.           would display all files that have a length of zero.
  676.  
  677.                          TARGET *.* -GT500000
  678.  
  679.           would display all files that are larger than 500,000 bytes.
  680.  
  681.                          TARGET *.* -GT1023 -LT2049
  682.  
  683.           would display all files that are from 1,024 to 2,048
  684.           bytes in size, inclusive.
  685.  
  686.  
  687.      Switch:  -S -B
  688.     Meaning:  specify a file date range
  689. Description:  These switches allow you to search only for files within a
  690.           certain date range.  These switches are the "since" (S)
  691.           switch and the "before" (B) switch.  Both switches come in
  692.           two flavors; you can specify the date in number of days
  693.           (eg: -S5) or with a full date (eg: -S8-19-89).   If you
  694.           specify either switch with no date specifier, then it defaults
  695.           to '0 days'.  These date specifiers are also used when looking
  696.           inside of archive files.  Some examples:
  697.  
  698.                           TARGET *.PAS -S5
  699.  
  700.           would display all .PAS files that have a date greater than or
  701.           equal to 5 days ago (in other words, modified SINCE 5 days ago).
  702.  
  703.                           TARGET *.PAS -S5-1-89
  704.  
  705.           would display all .PAS files modified SINCE 5/1/89.
  706.  
  707.                           TARGET *.PAS -B5
  708.  
  709.           would display all .PAS files modified BEFORE 5 days ago.
  710.  
  711.                           TARGET *.PAS -B5-1-89
  712.  
  713.  
  714.  
  715. TARGET Version 1.6BETA                                    Page 13
  716.  
  717.  
  718.           would display all .PAS files modified BEFORE 5/1/89.
  719.  
  720.                           TARGET *.PAS -S5-1-89 -B6-1-89
  721.  
  722.           would display all .PAS files modified between the dates of
  723.           5-1-89 and 5-31-89.
  724.  
  725.                           TARGET *.PAS -S
  726.  
  727.           would display all .PAS files that have been modified today
  728.           (defaults to '-S0').
  729.  
  730.  
  731.      Switch:  -Z
  732.     Meaning:  show only files with their archive bit set
  733. Description:  The '-Z' switch allows you to display only those files which
  734.           have their "archive bit" set on.  In other words, it will show
  735.           all files that have been modified since your last backup (if
  736.           your backup program clears the archive bit, that is).
  737.  
  738.  
  739.      Switch:  -HIDDEN
  740.     Meaning:  also show hidden and system files
  741. Description:  The '-hidden' switch allows you to also display those files
  742.           which are "system" and "hidden" files.
  743.  
  744.  
  745. FILE MANIPULATION FACILITIES
  746.  
  747.       Switch:  -C"command to execute"
  748.            -CV"command to execute"
  749.            -O"command to display"
  750.      Meaning:  Execute (or display) a DOS command or application program
  751.            on all files found.
  752.  Description:  This switch tells TARGET to execute the command or program
  753.            within the double quotes on each matching file found.  If the
  754.            referenced program is not a DOS command, then it must be
  755.            found in the system PATH.
  756.  
  757.                TARGET provides access to replaceable parameters that
  758.            can pass the full filename, the pathname only, the filename
  759.            only, or the name of the archive member (if you're searching
  760.            archives) to the command or program.
  761.  
  762.            When you use the -cv switch, it operates identically to the
  763.                -c switch, except that TARGET will ask you for confirmation
  764.            before it actually executes the command.
  765.  
  766.  
  767.  
  768.  
  769.  
  770. TARGET Version 1.6BETA                                    Page 14
  771.  
  772.  
  773.                The -o switch prints the command it WOULD have executed to
  774.            the screen.  You may use this as a test before doing the
  775.                -c command to make sure that what you think you told TARGET
  776.            to do is the same as what you DID tell it to do.  A more
  777.            important use of the -o command is to redirect all of the
  778.                TARGET output into a batch file that you can execute later.
  779.  
  780.            Replacement parameters for the DOS command or program being
  781.            executed for both -c and -o are as follows:
  782.  
  783.  
  784.     Parm      Desc           Normal example      Archive example
  785.     ----      ----          -----------------   -----------------
  786.      &f   full file name    c:\dos\xcopy.exe    c:\dos\comlib.zip
  787.      &p   path name only    c:\dos\             c:\dos\
  788.      &d   directory name    c:\dos              c:\dos
  789.      &n   file name only    xcopy.exe           comlib.zip
  790.      &m   archive member    <blank>             xcopy.exe
  791.      &r   root of the name  xcopy               xcopy
  792.      &&   the '&' char
  793.  
  794.           EXAMPLES:
  795.  
  796.            1)  You have many .DOC files straying all over your hard drive,
  797.            and you'd like to incorporate them all into one simple
  798.            ZIP file.  You could do this with the following command:
  799.  
  800.                       C:> TARGET -d *.doc -c"pkzip -m c:\docs.zip &f"
  801.  
  802.            2)  You want to make a copy of all of your Pascal source code
  803.            that has been changed today so that you can take it home
  804.            with you:
  805.  
  806.                       C:> TARGET -d *.pas -s0 -c"copy &f a:\"
  807.  
  808.            3)  You want to get a text file listing of every directory
  809.            name on your hard drive(s) in the file HARDRIVE.DAT:
  810.  
  811.                       C:> TARGET -d nul -o"&p" >c:\Hardrive.Dat
  812.  
  813.            4)  You want to delete every .BAK file on your system (even
  814.            those that are in ZIP files).  This would be a 2-step
  815.            process:
  816.  
  817.            First, delete the normal .BAK files
  818.  
  819.                       C:> TARGET *.bak -v -n
  820.  
  821.            Then, delete them from the archive files
  822.  
  823.                       C:> TARGET -d -ao -zip *.bak -c"pkzip -d &f &m"
  824.  
  825. TARGET Version 1.6BETA                                    Page 15
  826.  
  827.  
  828.      Switch:  -V [-N]
  829.     Meaning:  do a verified delete of any matching files found
  830. Description:  These switches tell TARGET to delete any matching files found.
  831.               If you specify only the '-V' switch, then TARGET will prompt
  832.           you before it deletes each file.  If you specify BOTH the '-V'
  833.               and the '-N' switch, then TARGET --WILL NOT-- prompt you.
  834.           Example:
  835.  
  836.                           TARGET *.bak -v
  837.  
  838.  
  839.      Switch:  -SCAN
  840.     Meaning:  Perform a virus scan on any matching files
  841. Description:  The McAfee Associates' SCAN program must be in the system
  842.           PATH to use this function.
  843.  
  844.      Switch:  -UPDATEfilename or -UPDATE@filename
  845.     Meaning:  Replace files of the same name with this specific file
  846. Description:  This switch allows TARGET to update multiple copies of
  847.               a program (usually found across multiple drives or on a
  848.               network drive) with a newer version.  This feature helps
  849.               standardize programs at a certain version.  If @filename
  850.               is used, TARGET will look for an ASCII text file named
  851.               "filename" and update all files listed in it.  The text
  852.               file must have only one file listed per line.  This feature
  853.               can be used to update several programs at once, such as the
  854.               VIRUSCAN, VSHIELD, and CLEAN-UP programs.
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880. TARGET Version 1.6BETA                                    Page 16
  881.  
  882.  
  883. The TARGET and Target_DRIVES Environment Variables
  884.  
  885.      When TARGET begins execution, it searches the environment for a variable
  886. named TARGET.   If this variable is present, its contents will be appended
  887. onto the command line just as if you had entered them in from the keyboard.
  888. This option is very handy for setting "default options" that you'd like for
  889. TARGET to perform every time.   Simply set the TARGET variable in your
  890. AUTOEXEC.BAT file.   For example, if you'd like to always (a) page break
  891. when the screen fills up, (b) display the filenames on the right of the
  892. screen, and (c) display output in upper case, you would put the following in
  893. your AUTOEXEC.BAT file:
  894.  
  895.                     SET TARGET=-P -R -U
  896.  
  897.      TARGET would then use these options every time you executed the program.
  898.  
  899.      If you specify the "-d" switch (search all drives), then TARGET will
  900. search the environment looking for a variable named Target_DRIVES.   If this
  901. variable is found, TARGET will use this list as the definition of the
  902. drives to search.  If the Target_DRIVES variable does not exist, TARGET will
  903. use its own list, which defaults to drives c: through z: (ie: cde...z).
  904.  
  905.      The Target_DRIVES variable is needed mainly by people using networks.
  906. TARGET's reckless abandon of simply searching all drive letters caused
  907. some network users a lot of headaches.   It seems that those affected the
  908. most were users of Novell networks.   On Novell, you can specify many
  909. different drive letters for the same "volume" (ie: partition), so TARGET
  910. would show the same physical file many times, since TARGET thought that
  911. it was really on a different drive.   With the Target_DRIVES variable, it is
  912. up to the user to tell TARGET what drives are physically different.  For
  913. example, let's assume that you have 3 volumes defined, and the drive letter
  914. assignments are as follows:
  915.  
  916.      Volume 1  -     drives C: and D:
  917.      Volume 2  -     drives E: and F:
  918.      Volume 3  -     drives G: and H:
  919.  
  920.      For TARGET to work correctly, you would put the following line in your
  921. AUTOEXEC.BAT file:
  922.  
  923.             Set Target_DRIVES=CEG
  924.      or
  925.             Set TA_DRIVES=CEG
  926.  
  927.      (TARGET will accept TA_DRIVES for the drive searching environment
  928. variable in place of Target_Drives).
  929.  
  930.      Now, when you search using the "-d" switch, TARGET won't list duplicate
  931. filenames.  If the Target_DRIVES Environment Variable exists, it is used
  932. every time.  If you need to search a different list, you must specify a
  933. drive list with the filename instead of using the "-d" switch.  For
  934. example, "TARGET cdfg:*.bat".
  935. TARGET Version 1.6BETA                                    Page 17
  936.  
  937.  
  938.      Upper and lower case is not significant in the names of the environment
  939. variables.  NOTE that no colon is used in the Target_DRIVES environment
  940. variable; only the drive letters are listed.
  941.  
  942.  
  943. REGISTRATION
  944.  
  945.      A registration fee of $20.00US is required for the use of
  946. TARGET by individual home users.  Registration is for one year
  947. and entitles the holder to unlimited free upgrades off of McAfee
  948. Associates' BBS the McAfee Virus Help Forum on CompuServe (GO
  949. MCAFEE), and the Internet mcafee.COM anonymous ftp site.  When
  950. registering, a diskette containing the latest version may be
  951. requested.  Add $9.00US for diskette mailings.  Only one diskette
  952. mailing will be made.
  953.      Registration is for home users only and does not apply to
  954. businesses, corporations, organizations, government agencies, or
  955. schools, who must obtain a license for use.  Contact McAfee
  956. Associates for more information.
  957.      Outside of the United States, registration and support may be
  958. obtained from the Agents listed in the accompanying AGENTS.TXT
  959. file.
  960.  
  961.  
  962. TECH SUPPORT
  963.  
  964.      For fast and accurate help, please have the following
  965. information prepared when you contact McAfee Associates:
  966.  
  967.      -    Program name and version number.
  968.  
  969.      -    Type and brand of computer, hard disk, plus any
  970.       peripherals.
  971.  
  972.      -    Version of DOS you are running, plus any TSRs or device
  973.       drivers in use.
  974.  
  975.      -    Printouts of your AUTOEXEC.BAT and CONFIG.SYS files.
  976.  
  977.      -    The exact problem you are having.  Please be as specific
  978.       as possible.  Having a printout of the screen and/or
  979.       being at your computer will help also.
  980.  
  981. McAfee Associates can be contacted by CompuServe Forum, BBS, fax, or
  982. InterNet 24 hours a day, or call our business office at (408) 988-3832,
  983. Monday through Friday, 7:00AM to 5:30PM Pacific Time.
  984.  
  985.      McAfee Associates               (408) 988-3832 office
  986.      3350 Scott Blvd., Bldg. 14      (408) 970-9727 fax
  987.      Santa Clara, CA  95054-3107     (408) 988-4004 BBS (32 lines)
  988.      U.S.A                           USR HST/v.32/v.42bis/MNP1-5
  989.                      CompuServe    GO MCAFEE
  990.                                      Internet      support@mcafee.COM
  991.  
  992.  
  993.